Skip to main content

Types of promotions

APIO allows merchants to create promotions to offer temporary or conditional discounts on their products.

Promotions are designed to be simple, predictable, and transparent, with clear applicability rules to avoid confusion during checkout and billing.

Promotion Scope​

Promotions in APIO can be applied at different levels:

  • Product-level promotions
    Applied to a specific product and evaluated during checkout or subscription creation.

  • Subscription-level promotions
    Applied directly to an existing subscription.

Product-Level Promotions​

Product-level promotions apply:

  • To a specific product
  • To one billing frequency only

This ensures that promotions remain easy to understand and prevents unintended pricing behavior across different subscription frequencies.

Subscription-Level Promotions​

APIO also allows promotions to be applied directly to a subscription.

To apply a subscription-level promotion, the following are required:

  • The user who owns the subscription
  • The subscription to which the promotion will be applied

This enables targeted discounts for:

  • Retention campaigns
  • Customer support adjustments
  • Personalized offers

Restriction:

  • For this is important to notice that the user must have an active subscription to apply the promotion.

Subscription-level promotions override product-level promotions for that specific subscription.

Billing Frequency Restriction​

A promotion cannot apply to multiple billing frequencies at the same time.

Example:

  • A promotion can apply to:
    • Monthly subscriptions or
    • Single purchases
  • It cannot apply to both within the same promotion

If you want to promote multiple billing types, you must create separate promotions for each frequency.

Promotion Priority​

If multiple promotions are eligible for the same product, billing frequency, or subscription, APIO applies only one promotion.

  • The promotion with the highest priority is applied
  • Lower-priority promotions are ignored
  • Pricing remains deterministic and predictable

Priority is defined by the merchant during promotion configuration.

Promotion Behavior​

  • Promotions affect the final charged price
  • Promotions take priority over reference prices
  • Promotions are evaluated at checkout and before each billing cycle

Best Practices​

  • Use product-level promotions for general campaigns
  • Use subscription-level promotions for targeted offers
  • Always define promotion priorities
  • Avoid overlapping promotions with equal priority
  • Clearly communicate promotion conditions to users

APIO’s promotion system provides flexibility while ensuring clear, consistent pricing behavior.